home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / dosutils / wdir110c.zip / README.TXT < prev    next >
Text File  |  1996-10-17  |  14KB  |  414 lines
  1. [Wersting] D[ir] 1.10c
  2.  
  3. Copyright (C) 1995, 1996 Magnus BΣck
  4. http://www.geocities.com/SiliconValley/5159
  5. Ove.Back@derm.lu.se
  6.  
  7. ---------------------------------------------------------------------------
  8.  
  9. This document contains all you need to know about D, the best DIR
  10. replacement. [Wersting] D[ir] is freeware and may be freely distributed 
  11. on any electronic media as long as nothing is charged for it, except for 
  12. copying costs.
  13.  
  14. ---------------------------------------------------------------------------
  15.  
  16. Syntax
  17.  
  18. D.EXE [<files>] [<switches>] [@<configfile>]
  19.  
  20. These parameters may appear in any order on the command line. Switches are
  21. always preceded by a slash, "/". contains a directory and/or file mask for
  22. the files you want to display. There are known problems with the parsing of
  23. the parameter, so if you have any suggestions about how to do it in a
  24. fool-proof way, please tell me about it.
  25.  
  26. You can save your switches to a file and then use [@<configile>] to use 
  27. those parameters as defaults. Specify this in the WDIRCMD enviroment variable 
  28. in your AUTOEXEC.BAT. The configuration file is read every time D is executed, 
  29. so make sure it resides on a fast media. You can use this parameter on the 
  30. command line too, but that's pretty awkward. From version 1.10 and on, you 
  31. can place your own comments in the configuration file by placing a grid (#) 
  32. as the first character of a line. The maximum size of the configuration file
  33. is 4 kB.
  34.  
  35. ---------------------------------------------------------------------------
  36.  
  37. Switches
  38.  
  39. In alphabetical order
  40.  
  41. /?
  42.  
  43. Displays a help screen with a short command reference and color coding
  44. guide.
  45.  
  46. /43
  47.  
  48. Previously used to tell D that you were running on a 43 line display but is
  49. ignored from version 0.99d and on.
  50.  
  51. /A
  52.  
  53. Selects which files are to be displayed, regarding their file attributes.
  54. You can optionally specify one or many of the following parameters;
  55. specifying only /A will display all files, no matter what attributes they
  56. may have.
  57.  
  58.  A    Files with the archive attribute are displayed.
  59.  R    Read-only files will be displayed
  60.  H    Hidden files, ditto
  61.  S    System files, ditto
  62.  D    Directories, ditto
  63.  
  64. If you precede the parameter with a dash ("-"), you'll have an opposite
  65. effect and display all files except the ones specified.
  66.  
  67. Example
  68.  
  69.      /AH-R
  70.  
  71. This will display all files that are hidden, but not any read-only files.
  72.  
  73. /ARJ
  74.  
  75. Displays the contents of ARJ archives in the same way as /ZIP, /LZH and 
  76. /RAR. There is no support for file attributes inside the archives.
  77.  
  78. /B
  79.  
  80. Strips all file information except the name and extension and displays one
  81. file per row. No header or summary information is displayed.
  82.  
  83. /BA
  84.  
  85. Shows how many bytes are allocated for every directory. This is always a 
  86. multiple of the cluster size. Also, the waste percentage, i.e. how much 
  87. space is lost due to the clusters, is displayed.
  88.  
  89. /BMP
  90.  
  91. Displays the height, width, color depth and any compression algorithm used
  92. of all Windows bitmaps (*.BMP, *.RLE). The information is displayed after
  93. any attributes if /T is set, but before any long filename.
  94.  
  95. Example
  96.  
  97.      640x480x256 RLE8
  98.  
  99. /BW
  100.  
  101. All color-coding is switched off, everything is displayed in black and
  102. white.
  103.  
  104. /CLS
  105.  
  106. Clears the screen before doing anything.
  107.  
  108. /DA
  109.  
  110. Attributes are separated with dots/periods instead of spaces. This switch
  111. is not relavant if /T isn't specified.
  112.  
  113. /F50
  114.  
  115. Forces the screen into 50 line mode (43 lines for EGA screens). Automatically 
  116. pauses before going back to the previous video mode.
  117.  
  118. /FLIC
  119.  
  120. Displays the width, height, color depth and number of frames for Autodesk 
  121. animations (*.FLI and *.FLC). Width, height and color depth is always 
  122. 320x200x256 for FLI files, though.
  123.  
  124. /GIF
  125.  
  126. The width, height, color depth and version of Compuserve GIF images is
  127. displayed.
  128.  
  129. Example
  130.  
  131.      640x480x256 GIF89a Intr
  132.  
  133. This is a 640x480 256 color interlaced GIF89a bitmap.
  134.  
  135. /I
  136.  
  137. If you think the . and .. directories just fill your screen without reason,
  138. this might be useful. The switch takes one parameter:
  139.  
  140.  L    Does not display them in the directory listing
  141.  S    Ignores them in the summary
  142.  
  143. You may specify them both if you like. D is default to ignore them in the
  144. summary.
  145.  
  146. /JPG
  147.  
  148. Displays the width and height of JPEG (*.JPG) files. Color depth isn't
  149. relevant, all JPEGs are 24 bit.
  150.  
  151. /L
  152.  
  153. All filenames (though not long filenames) are converted to lower-case. Any
  154. letters above ASCII 127 aren't affected.
  155.  
  156. /LFN
  157.  
  158. The long filenames introduced in Windows 95 are displayed in bright white
  159. (see color coding) last on the line. If the name won't fit on the line, it
  160. will completely move on to the next line (i.e. LFNs aren't wrapped).
  161.  
  162. /LWN
  163.  
  164. Only displays the long filenames when it differs from the standard name. 
  165. It's case-sensitive, if the original name is WIN.INI, the LFN will be shown 
  166. if it is win.ini. This switch will eliminate screen clutter caused by all LFNs.
  167.  
  168. /LZH
  169.  
  170. This switch will display the contents of LZH archives (created by LHA). As
  171. with all archives, the contents is indented.
  172.  
  173. /NIC
  174.  
  175. When archives (ZIP, LZH and RAR) are found in a directory, the first bytes
  176. of the file are checked to see if it really is a valid archive. If you're
  177. DIRing a diskette, this might take a while. /NIC (No Integrity Check) will
  178. prevent this from happening. If the archive is recognized, the file will be
  179. displayed in yellow. When this switch is set, or if the archive doesn't
  180. appear to be valid, light cyan is used. See color coding.
  181.  
  182. /NOWARN
  183.  
  184. No warnings will be issued with this switch set. These are the occasions
  185. when warnings will occur:
  186.  
  187.    * If more than one file path and/or file mask i specified. All
  188.      parameters not beginning with slash ("/") or at ("@") is considered to
  189.      be file masks. The second file mask will be ignored and the first one
  190.      will be used.
  191.    * When an invalid parameter to the /O is used. Only G, N, E, D and S are
  192.      valid. That parameter will be skipped and the parsing will continue
  193.      with the next parameter to the /O switch (if there is one).
  194.    * Ditto, if an invalid parameter to the /A is used. Only A, D, R, H and
  195.      S are valid. That parameter will be skipped and the parsing will
  196.      continue with the next parameter to the /A switch (if there is one).
  197.    * If both /W and some archive switch is used, a warning informs that the
  198.      archive contents won't be displayed.
  199.    * If /LFN is set, and your DOS version doesn't support long filenames
  200.      (to this date, only MS-DOS 7.0 found in Windows 95 does this).
  201.    * When two conflicting switches are set, i.e. if you specify both /OG
  202.      and /O-G. The second switch will be ignored.
  203.    * When a ZIP archive is too big, this usually happens with archives
  204.      larger than 1000 files.
  205.  
  206. /O
  207.  
  208. Selects sord order to use, and can be one or more (can only be more than
  209. one if G is specified) of the following:
  210.  
  211.  G   Groups the directories together in the beginning of the listing.
  212.  N   Sorts ascending (A-Z) by name.
  213.  E   Ditto by extension.
  214.  D   Ditto by date, oldest first.
  215.  S   Ditto, by size, smallest first.
  216.  
  217. By preceding a letter with a dash ("-"), the sort order will be reversed to
  218. descending.
  219.  
  220. /P
  221.  
  222. The output will be paused for every screen and a key must be pressed to
  223. continue.
  224.  
  225. /PCX
  226.  
  227. Displays the width, height and color depth of ZSoft PCX files.
  228.  
  229. /RAR
  230.  
  231. This switch will display the contents of RAR archives.
  232.  
  233. /S
  234.  
  235. All subdirectories to the directory to be displayed will be recursed before
  236. displaying any output. A summary of all files found in all directories will
  237. be displayed at the end of the listing.
  238.  
  239. /SN
  240.  
  241. This will display the serial number of the drive you're listing.
  242.  
  243. /T
  244.  
  245. The attribute(s) of the file will be displayed after the time stamp. The
  246. attributes are be default separated by spaces, but can be separated by
  247. dots/periods with the /DA switch.
  248.  
  249. /TGA
  250.  
  251. Displays the width, height and color depth of Truevision TGA (*.TGA) images.
  252.  
  253. /W
  254.  
  255. Only the filename and extension will be displayed in five columns.
  256. Directories are displayed in brackets ([like this]) to clearify.
  257.  
  258. /WAV
  259.  
  260. Displays the sample rate in kHz and bit count for Windows Wave Sound (*.WAV).
  261.  
  262. /ZIP
  263.  
  264. This switch will display the contents of ZIP archives. If the ZIP is too 
  265. large, you are warned about this and the rest of the archive is skipped. In 
  266. the summary, you'll be informed how many of the files were displayed and the
  267. total file count. Normally, about 1000 files will display without memory
  268. problems.
  269.  
  270.  
  271. ---------------------------------------------------------------------------
  272.  
  273. WDIRCMD enviroment variable
  274.  
  275. To make D easier to customize, you may use the WDIRCMD enviroment variable
  276. to set default switches. It works in the same way as the standard DIRCMD
  277. variable for DIR. DIRCMD is checked by D, too. This is the order the
  278. parameters get parsed:
  279.  
  280.   1. DIRCMD enviroment variable
  281.   2. WDIRCMD enviroment variable
  282.   3. Any configuration file specified in WDIRCMD
  283.   4. The command line
  284.   5. Any configuration file specified in the command line
  285.  
  286. The best thing to do is to specify a configuration file in WDIRCMD. That
  287. way, you don't have to reboot to change the default behaviour. However,
  288. with this approach, the config file will be opened and read every time you
  289. call D, so make sure it resides on a fast drive.
  290.  
  291. ---------------------------------------------------------------------------
  292.  
  293. Version history
  294.  
  295. 1.10c (October 17th 1996)
  296.  
  297.    * File sorting performance increased by 85% due to a completely rewritten
  298.      sort routine.
  299.    * ZIP files that are too large don't result in a heap overflow and a program
  300.      crash. 
  301.    * /P works even better.
  302.    * Ctrl+S and Ctrl+C now works when listing archive contents.
  303.    * Various other smaller bug fixes (e.g. some embarrasing documentation
  304.      errors).
  305.  
  306. 1.10b (September 4th 1996)
  307.  
  308.    * Long filenames are disabled when running in MS-DOS mode under Windows 95
  309.      since this has caused some systems to crash.
  310.    * TGA image support.
  311.    * /P now works correctly with archives.
  312.  
  313. 1.10a (August 5th 1996)
  314.  
  315.    * Memory management is better, no more heap overflow when displaying a
  316.      large amount of files, e.g. when using /S from the root.
  317.  
  318. 1.10 (July 31st 1996)
  319.  
  320.    * The contents of ARJ archives are now displayed in the same way as ZIP, 
  321.      LZH and RAR archives. Activated with (surprise) /ARJ. 
  322.    * /LWN added. Prevents screen clutter by not displaying all long filenames. 
  323.    * The space allocated is shown with /BA. 
  324.    * Fixed bug that caused the file handles to run out when displaying archives. 
  325.    * Comments are allowed in configuration files. 
  326.    * Fixed bug the bug that sometimes placed one directory last in the listing, 
  327.      even when /OG was specified. 
  328.    * Shows file information on WAV and FLI/FLC files. 
  329.  
  330. 1.00a (June 19th 1996)
  331.  
  332.    * PCX images are supported with /PCX.
  333.    * TGZ archives and Lempel-Ziv compressed ??_ files are now displayed in
  334.      cyan like all other archives.
  335.    * Various bug fixes and optimizations.
  336.  
  337. 1.00 (May 19th 1996)
  338.  
  339.    * ZIP files are now displayed correctly. Previously, archives containing 
  340.      files with long filenames and/or directories were displayed as empty. 
  341.  
  342. 0.99e (April 24th 1996)
  343.  
  344.    * The date of files in ZIP arhives wasn't displayed correctly, which was
  345.      now fixed.
  346.    * Help page slightly changed with a new e-mail address and this URL
  347.      added.
  348.  
  349. 0.99d (March 28th 1996)
  350.  
  351.    * JPEG (*.JPG) support. Width and height is displayed. Activated with
  352.      /JPG.
  353.    * Support for the long filenames in Windows 95 through /LFN.
  354.    * /43 is no longer needed, D keeps track of the number of lines used.
  355.  
  356. 0.99c (March 3rd 1996)
  357.  
  358.    * A minor bug fix with the parameter parsing.
  359.  
  360. 0.99b (March 2nd 1996)
  361.  
  362.    * Full GIF support with /GIF.
  363.    * Serial number support with /SN.
  364.    * Predefined switches can be put in a separate configuration file with
  365.      @<configfile>.
  366.    * The directories . and .. can now be removed with /I.
  367.    * The 8087 emulation library was removed, reducing EXE size with about
  368.      10 kB.
  369.    * /PD was renamed to /DA.
  370.  
  371. 0.99a (Feb 20th 1996)
  372.  
  373.    * A scroll bug was removed.
  374.    * /S doesn't only displays summary information when there is a file
  375.      match in a sub-directory. Earlier, "0 files, 0 bytes ..." was
  376.      displayed for every directory searched (very annoying when doing a /S
  377.      in the root direcotory.
  378.    * ZIP archive support with /ZIP. No attributes are displayed yet, and
  379.      any subdirectories in the ZIP aren't displayed correctly.
  380.    * LZH archives are correctly identified.
  381.    * The file sorting algorithm was optimized and the performance increased
  382.      20%.
  383.  
  384. 0.99 (Feb 6th 1996)
  385.  
  386. The first release.
  387.  
  388. ---------------------------------------------------------------------------
  389.  
  390. Lacking features
  391.  
  392. Nothing's even close to perfect. These features will (hopefully) be added to D: 
  393.  
  394.    * More image formats (TIFF e.g.) and sound formats (AU) will be added. 
  395.    * The <TITLE> tag of HTML files will be shown to make it easier to identify
  396.      e.g. files in the Netscape cache directory. 
  397.    * Option to add more file extensions that are to be color coded.
  398.    * Progress meter when sorting files.
  399.    * Ability to have larger configuration files than 4 kB.
  400.  
  401. I'm not planning to include these features: 
  402.  
  403.    * Support for /C to display compression ratio of the files on compressed 
  404.      drives. If anyone knows how to do this, let me know. 
  405.  
  406. ---------------------------------------------------------------------------
  407.  
  408. Downloading updates of [Wersting] D[ir]
  409.  
  410. Currently, D is only available for downloading at GeoCities, but will soon be
  411. available on a Swedish server and, hopefully, ftp.cdrom.com.
  412.  
  413.    * WERSTDIR.ZIP (31 kB) from GeoCities 
  414.      http://www.geocities.com/SiliconValley/5159/werstdir.zip